home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / mult200.zip / MULTNODE.DOC < prev    next >
Text File  |  1991-12-11  |  33KB  |  619 lines
  1.  
  2.  
  3.           ****** MultiNode Batch File Setup for 3 Nodes ******
  4.              *** 2 "Live" nodes and 1 "Local Only" node ***
  5.  
  6.                       Copyright 1991 by Mark Lewis
  7.  
  8.                   All Right Reserved in Time and Space
  9.  
  10.  
  11.  
  12.  
  13. first things first <sigh>......
  14.  
  15.                          **** LEGALITIES ****
  16.  
  17. i do not guarrantee that the batch files and sample screen dumps contained 
  18. in this .ZIP will work _perfectly_ on your system. the .BAT files and
  19. samples in this archive are provided as is without warranty of any kind, 
  20. either expressed or implied. the only thing guarranteed about the files 
  21. included in this archive is that they will take up diskspace. if you find 
  22. that they do not serve your purposes, delete them. it's that easy. if they 
  23. break themselves on your system, you own both parts and cannot hold myself 
  24. liable for any damages to you or your system. this includes downtime and 
  25. is not limited to any monies lost due to downtime. also, these .BAT files 
  26. and the associated utilities mentioned *CAN NOT* and will not cause *ANY* 
  27. damage to your hardware or equipment!
  28.  
  29.  
  30.                        ***** REGISTRATION *****
  31.  
  32. now, don't take this part the wrong way<grin>.... if you find that these .BAT
  33. files and/or samples help you in your quest to become a multinode system, all
  34. i ask is that you NetMail Mark Lewis 1:275/50 and let me know that you are 
  35. using the basics outlined or the files included in this archive file. this 
  36. way i will know that others are interested in what i can provide and will
  37. encourage me to continue the development of this and other items/programs 
  38. that may help you in the development of your system for the use of your
  39. members. after all, what's the cost of a phone call compared to what you can 
  40. make and/or provide for the members of your BBS?
  41.  
  42.  
  43. now that that is over with... on to the real stuff....
  44.  
  45.  
  46.                         *** the REAL stuff ***
  47.  
  48. you will, in most cases, need to modify these files. before doing so,
  49. make sure you are working on a *copy* not the originals. i cannot provide
  50. help on code that has been modified without knowing what modifications
  51. were done and how they are being implemented. the first modification most
  52. likely needed will be the drive and systems directories for RA and FD.
  53. the included BBS.BAT runs everything from our C: drive whereas our test
  54. site unit runs everything from D: drive. if you stick with the "basics"
  55. and use <DRIVE:>\RA and <DRIVE:>\FD as your system directories, you will
  56. find modification much easier.
  57.  
  58. you will need a few utilities for these .BAT files to work correctly...
  59. a copy of DTR.COM and AT.COM will prove invaluable to help in the control
  60. of your modem at 'critical' times.... like making sure the phone is
  61. offhook when tossing mail or updating the bulletins and such. another
  62. utility that makes 'life easier' is DVCOMAND. i found it in DVCO12.ZIP
  63. a couple of months ago. also used in this setup are DVACTIVE, DAYNBR, SYSNL, 
  64. and SPAZ. DAYNBR is used to calculate the day of the year for some of the
  65. processing (the nodediff merging section), SYSNL is the nodediff merge 
  66. program that i use, and SPAZ is a "universal" unarchiver. and DVACTIVE is a 
  67. little utility i wrote to detect if we are running under DESQview. the 
  68. following archives should have been received with this package when you 
  69. FREQ'd it (if you FREQ'd MULTNODE or MULTINODE). if you didn't get them, you 
  70. should try to find them locally or FREQ them from 1:275/50 as DVCOMMAND, 
  71. DOSMODEM, DAYNBR, SYSNL, SPAZ. 
  72.  
  73. in this setup, DVCOMAND is used to delay operation of the .BAT file at key 
  74. points.... it can also be used to open other windows in the background for 
  75. 'event processing' which opens a lot of ideas (like tossing the mail in 
  76. another window opened especially for it) for me<grin>. DVCOMAND is also used
  77. to reopen any FD nodes that may be down when we go to process inbound mail.
  78.  
  79. you need to have your mail tosser configured and operating correctly so that 
  80. you can just put the commands you use for it into the BBS.BAT file when you
  81. go through and edit it for your setup. this package was written using IMAIL
  82. for the echomail handling. i haven't tried any other mail processing 
  83. utilities like GEcho or TosScan but, you can modify the BBS.BAT where 
  84. necessary to handle any other mail processing utilities you might want to 
  85. use. this package was also written using MBUtil for some of the messagebase 
  86. maintenance. you might want to get a copy of MBUtil110. it does the same 
  87. thing as RAMsg and has several other nice features. (MBUtil 120 should be out
  88. by the new year as of this writting)
  89.  
  90. i have changed the way i am packaging this stuff slightly. BBS.BAT has grown
  91. to be rather complex so i'm now including two copies of it. one, BBS.BAT, is
  92. not commented, and the other BBSCMNTD.BAT, is COMPLETELY commented. i highly 
  93. recommend that you print out a copy of BBSCMNTD.BAT and read through
  94. it so you can understand what is happening where and when. it's only about
  95. 15 (fifteen) pages ( the last one was only 9 -=B-) ) and there are some 
  96. loopbacks that take place and are confusing at times if you don't have a 
  97. printout to follow<<grin>>... one, in particular, that was fun to do, was the 
  98. ability for node 2 to toss mail if a packet came in on node 1 while node 2 
  99. was online with a user and this has been expanded so that node 3 has this 
  100. ability also. one major update to this release is the capability for any of 
  101. the nodes to also handle the new nodediff files and the new FIDOnews file. 
  102. it was too much of a pain in the arse to have to manually process them, so i
  103. decided to add that to this package. note that the inbound/outbound mail 
  104. tossing/scanning, nodediff, and FNews processing takes place As Soon As 
  105. Possible... in other words, they will sit in your inbound directory until all 
  106. the nodes are free of callers... then, and only then, will the LAST node out 
  107. take care of them. in the case of outbound mail, the BBS.BAT looks for the 
  108. ECHOMAIL.BBS and NETMAIL.BBS files in your BBS's messagebase directory... if 
  109. they, either one or both exist, then your mail processor's scanning function 
  110. should be run. in the case of both inbound and outbound mail waiting for 
  111. processing, the inbound mail packet is tossed before the outbound packet is 
  112. created. when we have completely multinode aware Tosser/Scanners at our 
  113. disposal, i will include another BBS.BAT file in this archive that doesn't 
  114. have all these loops controls and semaphore lockout files. at that time, 
  115. being a multinode mailer/bbs system will also be a *lot* easier (i think).
  116.  
  117. ok.... now on to the rest of the setup....
  118.  
  119. directory setups... with this new release of my MULTNODE package, we need 
  120. several new directories that weren't necessary or mentioned in my previous 
  121. releases. so i decided to include a tree structure in this version to help 
  122. you see how this set up works. this is pretty much a generic setup and will 
  123. work for almost any environment.
  124.  
  125. below is a tree structure that will show you the relationships of the 
  126. directories. here is a basic list of the directories and their purpose in 
  127. the set up. 
  128.  
  129. RA  -- this is where all the RA executable files and overlay files go. you
  130.        will also have some config files in here. i also have almost all my
  131.        bbs utilities located in this directory as well as the .BAT files for
  132.        all the doors i run.
  133.  
  134. RA\N? -- this directory is where you go to run FD and RA from... any files 
  135.          needed by RA will be created in this directory. FD will find and 
  136.          use all it's files from the FD\N? directory. it can do this because
  137.          the .BAT file tells it to look in there for it's files. some of your
  138.          doors and utilities may need to have seperate configuration files 
  139.          for operation by each node. in this case they wil probably have to
  140.          be in this directory also.
  141.  
  142. RA\MSGBASE -- this is where your message base and userbase files are kept. RA
  143.               and any utilities that manupilate the messagebase or userbase
  144.               files will probably need to be told to look here for them. 
  145.               there are some utilities that will look in your RA config files
  146.               to find the directories they need. in those cases, they will
  147.               need to be told to look in the RA\N? directory for the 
  148.               CONFIG.RA file, which should then direct them to any other 
  149.               directories they need.
  150.  
  151. RA\MENUS -- this is where you have all of the menus for your setup. with RA's
  152.             multiple language support, you will probably want to have 
  153.             seperate directories under this one with the required files for
  154.             each language. this is to keep them from getting mixed up and to 
  155.             make editing and modification easier.
  156.  
  157. RA\TXTFILES -- the same thing goes for this directory as for the menus.
  158.  
  159. in some installations, there will probably also be another directory for each
  160. languages questionaire files.
  161.  
  162. FD -- this is where you put all of FD's related executable and overlay files.
  163.  
  164. FD\N? -- this is where all of the files are created and stored for each node. 
  165.          each FD node will have it's own complete setup in it's own directory
  166.          and will look in it's own directory for it's control files. FD does
  167.          not perform like RA in that it will not share any configuration or
  168.          control files like RA does.
  169.  
  170. FD\N?\PACKET -- this is where each FD node will put and maintain it's own
  171.                 control-packet files. these little files are created and 
  172.                 maintained each time FD rescans the netmail directory looking
  173.                 for any outbound mail for the current event. this directory
  174.                 is NOT the same as the directory where your tosser will 
  175.                 create the new outbound mail bundles. this directory is for
  176.                 each FD node's own use and should not be used by any other
  177.                 program or node. this directory CAN reside on a RAM disk.
  178.  
  179. FD\NODELIST\SAVE -- this directories only purpose is to save a copy of last
  180.                     weeks nodelist before we process this weeks new one. this
  181.                     is in case that something happens and the processing gets
  182.                     FUBAR'd and your system is unable to use the newly made
  183.                     nodelist. it's a HECK of a lot easier to just copy last
  184.                     weeks from here instead of having to go download the 
  185.                     whole thing again. -=B-)
  186.  
  187. FD\NETMAIL -- this is where all your *.MSG netmail files go. this directory
  188.               is shared by all FD nodes.
  189.  
  190. FD\FILES -- this is the directory where FD receives all inbound mail bundles
  191.             and files that you have FileREQuseted.
  192.  
  193. FD\FILES\NEWS -- this is the directory that BBS.BAT will unarchive each weeks
  194.                  FIDO news into. personally, i read the FIDO snooze and do
  195.                  not really want to wait for it to be unarchived each time i
  196.                  get ready to read it. 
  197.  
  198. FD\PACKET -- this is the directory where all your outbound mail bundles are
  199.              put by your mail tosser.
  200.  
  201. FILES -- i have all my downloadable files in directories off this one. i like
  202.          keeping everything grouped together and under "headings". 
  203.  
  204. FILES\DIFFS -- this is the directory where i put all the nodediff and 
  205.                nodelist files that i keep on my system for download. this is
  206.                the directory that BBS.BAT is written to use when it does it's
  207.                new nodediff processing.
  208.  
  209. LOGS -- this is where i keep all my log files. each node creates and 
  210.         maintains their log in this directory. each node names it's .LOG
  211.         file different from all the other nodes. ie: RA node 1 uses RAN1.LOG
  212.         and RA node 2 uses RAN2.LOG, thus easily keeping them seperated and
  213.         also easy to view.
  214.         
  215.  
  216. now that i've told you what they are, let's look at the tree.....
  217.  
  218. C:\---|---RA----|--N1
  219.       |         |--N2
  220.       |         |--N3
  221.       |         |--MSGBASE
  222.       |         |--MENUS-----|--ENGLISH
  223.       |         |            |--<other language menu dirs>
  224.       |         |
  225.       |         |--TXTFILES--|--ENGLISH
  226.       |                      |--<other language text file dirs>
  227.       |
  228.       |---FD----|--N1-----------PACKET
  229.       |         |--N2-----------PACKET
  230.       |         |--NODELIST-----SAVE
  231.       |         |--NETMAIL
  232.       |         |--FILES--------NEWS
  233.       |         |--PACKET
  234.       |
  235.       |---FILES-|--DIFFS
  236.       |         |--<rest of your file areas>...
  237.       |
  238.       |---LOGS
  239.       |
  240.       |---<other directories>...
  241.  
  242. now, this is NOT the only way to set up your multinode system. different 
  243. people do the same things different ways. this is just the way that i do it
  244. and is only shown here to give you a better understanding of how everything 
  245. fits together. it is also here to point out other directories that are used
  246. by BBS.BAT in a couple of areas in it's processing.
  247.  
  248. ok, i guess by now you're saying, "Come on, man! Let's get on with it!" well,
  249. i guess you're right, so here we go... 
  250.  
  251. first, create the individual node directories (N1, N2, and N3) needed by RA.
  252. ie: D:\RA\N1 for RA node 1, ect... copy the CONFIG.RA file from your main RA 
  253. directory into each node's <DRIVE:>\RA\N? directory. this is necessary only 
  254. *if* you want to have _different_ system logon prompts, different colors and 
  255. echomail addresses for each node. you can share the CONFIG.RA between nodes 
  256. if you like. in the case of sharing the CONFIG.RA, you won't need to put a 
  257. copy in each nodes (N?) directory. in our setup, we have a different POINT 
  258. number for each of our nodes. and this, plus a few node specific prompts 
  259. causes us to go with the seperate copies of CONFIG.RA. If you decide to share 
  260. the CONFIG.RA, the command line parameters in the BBS.BAT will take care of 
  261. the port being accessed by RA. 
  262.  
  263. the following are the things that need to be changed in RACONFIG for each
  264. node, in the case of seperate CONFIG.RA's, you will have to be in the
  265. _specific_directory_ for the node you are modifying before you run RACONFIG. 
  266. also, note that any changes to the message areas, protocals, languages, or 
  267. files areas are "global" for the nodes as these files are shared in this set 
  268. up... with this in mind, you could have different file areas and message 
  269. areas for each node, but that kind of setup is not what this package was 
  270. created for, although it is very easily accomplished once you stop and think 
  271. about it<<GRIN>>...
  272.  
  273.                  1) your address ie: 1:275/50.0 for your node 1 and
  274.                     1:275/50.1 for node 2...
  275.                     if you want to run your other node(s) as POINTS off
  276.                     of your main node. 
  277.                                      *OR*
  278.                     you can get another node number and use that... 
  279.                     ie: 1:306/23 and 1:306/28...
  280.                     (hope you don't mind the plug, Josh<<grin>>)
  281.                                      *OR*
  282.                     you can use the SAME FIDO address for all your nodes.
  283.                     it's entirely up to you. personally, i like 
  284.                     "advertising" the fact that the messages originated
  285.                     on a multinode system <smile>...
  286.                  2) the modem port and the baud rate.
  287.                     note that in this BBS.BAT file, we use the command
  288.                     line over-rides to specify the port and baud rate
  289.                     in use for each node but it's better safe than sorry.
  290.                  3) the logfile names.....i made a directory and put *ALL*
  291.                     logfiles there.. ie: C:\LOGS <grin>.. each node, FD 
  292.                     included, must have it's own logfile.... 
  293.                     ie: node 1 - FDN1.LOG and RAN1.LOG..
  294.                     makes it easy, hunh?? <<grin>>
  295.                  4) the RA system directory stays the same 'cause that's
  296.                     where all the other configuration files are... RA
  297.                     looks in the current directory for it's needed
  298.                     configuration files and if it cannot find them, then
  299.                     it looks at the environment variable(s) set in the
  300.                     N?.BAT startup file(s).
  301.                  5) MOST important of all! tell RA that you are running
  302.                     multinode!
  303.  
  304.  
  305. now, as i have only used FrontDoor, this is the only one i can comment
  306. on.... create the N1 and N2 directories for each FD node. in each FD's SETUP,
  307. make the same changes as above. the environment variable, FD, gets set to the 
  308. each node's directory. FD look's for it's .FD configuration files in each 
  309. nodes defined system directory. just copy the needed .FD configuration files 
  310. into the node directories and configure each as an individual installation. 
  311.  
  312. you can share the .EXE's and .OVR's and must have your main FD directory 
  313. listed in your PATH. the inbound (file), outbound (packet), nodelist, and 
  314. netmail directories are all shared. each node has it's own ROUTE.FD and node 
  315. 2 doesn't send or poll for *any*thing but can receive mail or files and can 
  316. also handle FREQs. you will need to make a control-packet directory for each 
  317. FD node. i use C:\FD\N?\PACKET. tell each copy of FD to use this as it's 
  318. packet directory. your mail tosser needs to be configured to use the 
  319. C:\FD\PACKET directory and put the outbound mail bundles in there. FD rescans
  320. the netmail directory each time it comes online or when there is a change of
  321. events. it then creates control-packets in it's C:\FD\N?\PACKET directory.
  322. this directory can be on a RAM disk if you like. it's contents are recreated
  323. with each netmail directory rescan that takes place.
  324.  
  325. each copy of FD has it's own SETUP.FD which contains the information specific 
  326. for each FD node. the main thing here is the com port. each FD node also has 
  327. it's own EVENTS.FD file for node specific events. FOR EXAMPLE, node 1 is the 
  328. 'master' node. it exits at 6am to handle maintenance right after Zone Mail 
  329. Hour is complete. node 2 might, at this time, go into a polling routine. or, 
  330. another example.... ZMH... node 1 cannot have human callers during ZMH.... 
  331. but who says that node 2 cannot have them, thus you could still have your BBS 
  332. open 24 hours a day and still be within policy about ZHM access.
  333.  
  334. you need to tell FD to Create the .BAT file under FDSETUP->MAILER->ERRORLEVELS.
  335. without this function, you will not be able to pass the Time to Next Event from
  336. FD to RA. this also keeps you from having to duplicate your events inn both RA
  337. and FD.
  338.  
  339. node 1 is your 'master' node, if you will.... it does everything including
  340. all system maintainence. you may also have to tell each node to use the
  341. address of the other as an AKA if you run into problems with the second
  342. node not receiving mail destined for node 1 and visa versa... actually, this
  343. should be done anyway. node one is set up with your main address and is AKA
  344. your other addresses or point addresses. node 2 is set up with it's main 
  345. address as your other second node address or your point address and its AKA 
  346. your main address.
  347.  
  348. now, put the N1, N2, and N3 .BAT files that came with this package in your 
  349. path and the BBS.BAT in your main RA directory. make sure your DV, FD, RA, 
  350. and IMAIL directories are in your path. make SURE that you also load SHARE at 
  351. bootup. any other utilities you use should be in a directory that is in your
  352. path, also.... like the DVCOMAND, DVACTIVE, SPAZ, DOSMODEM, and DAYNBR 
  353. utilities that you might have received with this package. the sysnl files i
  354. recommend putting in your nodelist directory so they can be accessed during
  355. the nodelist processing portion of the .BAT file.
  356.  
  357. You DID edit the .BAT files for your specific directory structure, didn't 
  358. you? if not, do that now and don't forget to change the echomail handler
  359. if you don't use IMail. make sure you also get the N1, N2, and N3 .BAT files!
  360.  
  361. in DV, create PIF files for each node starting them with the .BAT file for 
  362. that node.... 
  363.  
  364. below is my DV PIF file for my node 1....note that i do NOT specify a 
  365. directory.... let the .BAT file control all movement<grin>... also, note that
  366. we do NOT say anything about using com ports. the use of the FOSSIL driver
  367. negates the need for DV to even know about that. if DV is told anything about
  368. the com ports, it seems to hamper the smooth operation we seek -=B-)
  369.  
  370. if you run ANY doors or other software that does direct screen writes, you 
  371. will need to say Yes to Writes Directly to Screen *AND* Virtualize 
  372. Text/Graphics. the reason is that you will see some strange things on the 
  373. screen. if you don't say Yes to Virtualize, then the system will revert to 
  374. 25 line mode which isn't too nice if you want to see several tasks running 
  375. at the same time. 
  376.  
  377.                -- *NOTE* The Keys To Use On Open Menu *NOTE* -- 
  378. these are what you use to open each node with. these also become the first 
  379. two characters of the P.rogram I.nformation F.ile which, using the below 
  380. sample, is named N1-PIF.DVP.... this is part is VERY *IMPORTANT*. in BBS.BAT 
  381. the section that checks for any nodes that are down and brings them back 
  382. online uses the SAME keys that YOU do to reopen the node in question! if you 
  383. do not use N1, N2, and N3 as the keys to open each of your nodes, then you 
  384. MUST modify that part of BBS.BAT to use the SAME keys that you do...
  385.  
  386. ============================ snip ======================================
  387.  
  388.                                Change a Program
  389.  
  390.  Program Name............: RA Node 1
  391.  Keys to Use on Open Menu: N1                    Memory Size (in K): 1
  392.  Program...: n1.bat
  393.  Parameters:
  394.  Directory.:
  395.  Options:
  396.                   Writes text directly to screen.......: [N]
  397.                   Displays graphics information........: [N]
  398.                   Virtualize text/graphics (Y,N,T).....: [N]
  399.                   Uses serial ports (Y,N,1,2)..........: [N]
  400.                   Requires floppy diskette.............: [N]
  401.  
  402.   Press F1 for advanced options
  403.                       
  404.                       Change a Program Advanced Options
  405.  
  406.  System Memory (in K).......: 0 Maximum Program Memory Size (in K)..: 400
  407.  Script Buffer Size.......:   0 Maximum Expanded Memory Size (in K):  256
  408.  Text Pages: 1  Graphics Pages: 0   Initial Mode:    Interrupts: 00 to FF
  409.  Window Position:
  410.     Maximum Height:  25     Starting Height:   1     Starting Row...:  24
  411.     Maximum Width.:  80     Starting Width.:  80     Starting Column:   0
  412.  
  413.                                 Shared Program
  414.  Pathname..:
  415.  Data......:
  416.  Close on exit (Y,N,blank)......: [N] Uses its own colors...........: [Y]
  417.  Allow Close Window command.....: [Y] Runs in background Y,N,blank).: [Y]
  418.  Uses math coprocessor..........: [N] Keyboard conflict 0-F)........: [0]
  419.  Share CPU when foreground......: [Y] Share EGA when forgrnd/zoomed.: [Y]
  420.  Can be swapped out (Y,N,blank).: [N] Protection level (0-3)........: [0]
  421.  
  422. ================================ snip ===================================
  423.  
  424. here is a screen dump of my RA node 1 directory...
  425.  
  426. DV BBS | D:\RA\N1 >dir
  427.  
  428.  Volume in drive D has no label
  429.  Directory of  D:\RA\N1
  430.  
  431. .            <DIR>    3-21-91  5:02p
  432. ..           <DIR>    3-21-91  5:02p
  433. RABIMCFG 1        739 3-21-91  6:57p  */part of RABIM BiModem interface
  434. RABIMPTH 1         63 3-21-91  6:57p  */  "  "   "      "         "
  435. TIMELOG  BBS       71 4-10-91  2:24a  */created by each node
  436. FX-CHAT  CFG       67 3-21-91  6:13p
  437. POPDOOR  CFG      818 3-21-91 10:25p
  438. QUICKED  CFG      532 3-21-91  8:44p  */Quicked config different for nodes
  439. RAMAIL   CFG      160 4-10-91  2:13a  */RAMail config for this node
  440. RA-BIM   CTL      150 3-21-91  6:55p  */part of RABIM BiModem interface
  441. USA      CTL     2576 1-14-91  4:01p
  442. POPDOOR  DAT     8181 4-11-91  2:21a
  443. POPUSER  DAT      191 4-11-91  2:21a
  444. QUICKED  HLP     2784 1-25-90  1:10a  */help file for Quicked, if used
  445. CONFIG   RA      3186 4-10-91  1:38a  */config file for this node
  446. DORINFO1 DEF      105 4-10-91  2:24a
  447.        17 File(s)   5957632 bytes free
  448.  
  449. DV BBS | D:\RA\N1 >
  450.  
  451. as you can see, you also need the config and control files for some of
  452. your utilities and doors in each nodes directory.... note that the main
  453. changes in these files are the same as for the RA config file.... port
  454. assignment (in some cases) and directory to find needed drop files... 
  455. experimentation is the only thing here... 
  456.  
  457. also note that any doors you run might need the DORINFO1.DEF and/or the 
  458. EXITINFO.BBS file(s) copied into their working directory... here is a prime 
  459. example of using the environmental variables that are set in the N?.BAT 
  460. files and in BBS.BAT..... here is a sample from my ACFiles .BAT file that i 
  461. had up for testing. note that any single node doors you run will need to use
  462. semaphore files to lockout any other node that may try to access it while
  463. it's in use.
  464.  
  465. ================================ snip ===================================
  466.  
  467. d:                                   //* make sure correct drive
  468. cd\ra\acfiles                        //* goto the directory
  469. if %port% == 0 got regl              //* check for local mode
  470. type d:\ra\helpreg.txt > com%port%:  //* display "help register" to user
  471. goto regend                          //* jump over local display stuff
  472. :regl
  473. type d:\ra\helpreg.txt               //* display reg text locally
  474. :regend
  475. dvcomand wait 30                     //* delay 3 seconds for reading
  476. if exist imup.txt goto oops!         //* check for lockout file
  477. rem > imup.txt                       //* create lockout file
  478. copy d:\ra\%node%\dorinfo1.def       //* copy needed drop files
  479. acfiles                              //* run door
  480. del imup.txt                         //* remove lockout file
  481. d:                                   //* go back to bbs drive
  482. cd\ra\%node%                         //* goto correct node directory
  483. goto end                             //* goto end of .BAT file
  484. :oops!
  485. if %port% == 0 goto oops!l
  486. echo OOPS! > com%port%:
  487. echo I'm sorry. Someone else is using this door right > com%port%:
  488. echo now. Please try back in a few minutes. > com%port%:
  489. echo Thank you > com%port%:
  490. dvcomand wait 30
  491. goto end
  492. :oops!l
  493. echo OOPS!
  494. echo I'm sorry. Someone else is using this door right
  495. echo now. Please try back in a few minutes.
  496. echo Thank you.
  497. dvcomand wait 30
  498. :end                                 //* finished, return to bbs
  499.  
  500. ================================= snip ==================================
  501.  
  502. as you can tell above, the most used EV's (environment variables) are
  503. going to be %node% and %port%..... these are set in N?.BAT and in
  504. BBS.BAT respectively.....and also, this .BAT file makes use of a semaphore
  505. lockout file for a single node door.... multinode doors are much
  506. simpler<grin> and should include instructions for running them in a
  507. multinode situation. you CAN use %1 instead of %port% *IF* you put *B as the
  508. FIRST item after the .BAT filename in the RAMenu optional data line.
  509.  
  510.      ie: *C /C d:\ra\acf.bat *B *M
  511.  
  512. with RA, if you are in LOCAL mode, the baud rate (*B above) will ALWAYS
  513. be 0. the above line will be sent to dos as ......
  514.      
  515.      d:\ra\acf.bat 0
  516.  
  517. and the 0 will be substituted in the .BAT file everywhere %1 is used. 
  518. further explanation of this feature of .BAT files is beyond the scope of 
  519. this package. please refer to your DOS manual about replacable parameters 
  520. in batch files for further information.
  521.  
  522. RAMail is another door where using environment variables and replacable 
  523. parameters is necessary. RAMail reads the config file specified on the
  524. command line. for each node this will be a different config file and a .BAT
  525. file is necessary to do this with if you keep each of the node's RAMail.CFG 
  526. files in the same directory. next is a .BAT file sample for RAMail...
  527.  
  528.      ie: RAMail ramail%node%.cfg
  529.  
  530. in the N1.BAT file, the environment variable NODE is set to N1. in N2.BAT, 
  531. the same variable is set to N2. under DV, each task has it's OWN environment
  532. and is treated as if it was one individual machine. the above line, when
  533. accessed by node 1, will be sent to DOS as....
  534.  
  535.      RAMail ramailN1.cfg  ... for node 2 it's ... RAMail ramailN2.cfg
  536.  
  537. in several cases, like RAMail and Quicked, you can also just put the .CFG 
  538. files in each RA nodes directory and then just call it without having to use 
  539. a .BAT file. 
  540.  
  541. in some cases, like above, you will have to have multiple config files for 
  542. some doors. these doors will, then, either have an option for specifing 
  543. which config file they should use (RAMail mentioned above does this) or will 
  544. read the default config file... if they insist on reading a default config 
  545. file, then your .BAT will have to copy the correct config file to the 
  546. default config file name *after* locking out the other nodes and before 
  547. starting the door.... there are working door .BAT files for several doors 
  548. included in this archive. they can be found in DOORBATS.ZIP and can, in most 
  549. cases be used as they stand. you will only need to modify the drive and 
  550. directory calls. take a look at them and see how each one acts. for several
  551. of them, you will need to refer to the docs for that door to see what the 
  552. command line params need to be that are passed to the .BAT file from the
  553. optional data line in the menu and then on to the door. WAR.BAT for Global 
  554. War is one that DEFINATELY comes to mind.
  555.  
  556.                           ** in closing **
  557.  
  558. this should give you a good headstart into a multinode setup.... you are
  559. free to modify the .BAT files, as needed, for *your* system. if you pass
  560. this .ZIP file on to others, it must be distributed in it's original
  561. ummodified form. you may, if you desire, convert this .ZIP to any other
  562. archive format... ie: .LZH, .ARJ, etc...  if you find a unique problem or
  563. a fix for one that i haven't spotted and taken care of, i am definately
  564. interested in knowing about it.... in fact, you could send your mods/ideas
  565. to me if you like<grin>... and, i'm always interested in new ways to do
  566. things<<grin>> so if you spot a place where these .BAT files could use a
  567. little bit of streamlining, let me know.
  568.  
  569. i would like to thank The Spirit of Support -=FBBS=- (1:275/20), Dawn Patrol 
  570. (1:275/50), Nite Moves -=FBBS=- (1:275/22), the SysOps and CoSysOps, and the 
  571. members of these three BBS' for their help, time and understanding during the 
  572. development and debugging of this package. Without them, their help, wants, 
  573. needs and ideas, i would never have developed this package to the extent that 
  574. i have. 
  575.  
  576.                     Thank You All For Your Support!
  577.  
  578.                         and happy multinodeing,
  579.  
  580.                    .\\ark Lewis - CoSysOp at Large
  581.  
  582.                             Netmailable at 
  583.  
  584.                          FIDONet 1:275/50.100
  585.  
  586.                            and available in
  587.                              these FIDONet
  588.                          EchoMail Conferences
  589.  
  590.                                RA_UTIL
  591.                                RA_SUPPORT
  592.                                FDECHO
  593.  
  594. the above documentation and included .BAT files brought to you by ... 
  595.  
  596. .\\ark's Advanced Batch File Programming Techniques -=B-)
  597.  
  598.  
  599.                       ***** Copyright Notices *****
  600.  
  601. FrontDoor     Copyright 1989, 1990 by Joaquim H. Homrighausen 
  602.                          and Peter Stewart
  603. Tosscan       Copyright 1989, 1990 by Joaquim H. Homrighausen
  604. Remote Access Copyright 1989-91 by Andrew Milner
  605.                         and Continental Software
  606. IMail         Copyright 1990, 1991 by Fabiano Fabris
  607.                          for Intuition Software
  608. DTR.COM       Copyright 1985 by Donavon Kuhn and Jon Niedfeldt
  609. AT.COM        Copyright 1985 by Donavon Kuhn and Jon Niedfeldt
  610. DVCOMAND      Copyright 1989 by William E. Allen
  611. ACFiles       Copyright 1991 by Ray Cole
  612. RAMail        Copyright 1991 by Randy Blackmond
  613. Global War    Copyright 1989, 1990 by Joel Bergen
  614. Gecho         Copyright 1991 by Gerard van der Land
  615. DAYNBR        Copyright 1985 by Ben Baker
  616. Spaz          Copyright 1989, 1990 by Dan Thomson and Andrew Farmer
  617. SysNL         Copyright 1988, 1989, 1990 by Constellation Software
  618. DVActive      Public Domain  Written by Mark Lewis               
  619.